home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / util / cli / SmartPrompt.lha / SmartPrompt / SmartPrompt_pol.doc‾ < prev    next >
Encoding:
Text File  |  1998-09-26  |  10.7 KB  |  258 lines
  1.  
  2.               SmartPrompt v1.0 Smart shell Prompt enhancement
  3.                                Documentacja
  4.                              26 Wrzesieï, 1998
  5.  
  6.          Copyright (C) 1998 by Adrian Zurek. All rights reserved.
  7.  
  8.  
  9.  
  10.     TE NUDNE SPRAWY... :)
  11.     =====================
  12.  
  13.     Program SmartPrompt i jego  dokumentacja  zostaîy napisane  przeze mnie
  14.  czyli Adriana Ûurka :))  Takûe ja posiadam prawa autorskie  dotyczâce tego
  15.  programu.
  16.  
  17.  Ten program  to GNU  -  teraz naleûaîoby  przedstawiê  polskie tîumaczenie
  18.  skróconego opisu licencji GNU,  jednakûe nie posiadam jej a i tîumaczyê mi
  19.  sië za bardzo tego nie  chce wiëc musicie sië  zadowoliê angielskâ  wersjâ
  20.  (swoja drogâ ciekawe czy to ktoô w ogole czyta :)))
  21.  
  22.  This program is  free software;  you can redistribute it  and/or modify it
  23.  under the terms of the GNU General Public License as published by the Free
  24.  Software Foundation;  either version 2 of the License, or (at your option)
  25.  any later version.
  26.  
  27.  This program  is distributed in  the hope  that  it  will  be useful,  but
  28.  WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  29.  or  FITNESS FOR A PARTICULAR PURPOSE.  See  the GNU General Public License
  30.  for more details.
  31.  
  32.  You should  have  received a copy of  the GNU General Public License along
  33.  with this program; see the file COPYING.
  34.  If not, write to the Free Software Foundation,
  35.  675 Mass Ave, Cambridge, MA 02139, USA.
  36.  
  37.  Do programu  nie dajë  ûadnej gwarancji.  Uûywaj  tego programu  na wîasnâ
  38.  odpowiedzialnoôê, bez wzgledu na to do czego go uûywasz. Nie zapîaciîeô za
  39.  niego, wiëc nie oczekuj cudów.
  40.  
  41.  
  42.     KONTAKT
  43.     =======
  44.  
  45.  Moûesz sië skontaktowaê ze mnâ poprzez zwykîâ pocztë:
  46.  
  47.     Adrian Ûurek
  48.     ul. Mieszczaïska 5/55
  49.     93-322 Lódú
  50.     Polska
  51.  
  52.  lub poprzez e-mail piszâc na adres:
  53.  
  54.     adek@plukwa.pdi.net
  55.  albo ewentualnie:
  56.     adek@rast.lodz.pdi.net
  57.  
  58.  Jeôli jesteô  zaznajomiony  z IRCem,  moûesz zîapaê mnie  (nick  aDEk)  na
  59.  IRCNET'cie  na kanaîach  #amigapl (jëzyk polski),  #seasons,  #amigaexotic
  60.  (angielski).
  61.  
  62.  
  63.     JAK TO DOSTAÊ
  64.     =============
  65.  
  66.  Moûesz dostaê ten program ode mnie (patrz wyûej) lub przez anonimowe FTP z
  67.     ftp://plukwa.pdi.net/PL-A-Net/util/shell
  68.  BTW: stâd takûe moûesz ôciâgnâê inny mój program:
  69.     AScreen (archiwa as_xx-xx.lha)
  70.  lub prawdopodobnie z
  71.     Aminet/util/shell (ale nie byîbym tego taki pewien :))
  72.  
  73.  
  74.     WSTËP
  75.     =====
  76.  
  77.     Czy czasami korzystasz z UNIXa? Jeôli tak, prawdopodobnie zauwaûyîeô ûe
  78.  shelle *IXowe sâ bardzo dobrze zorganizowane i ich prompty mogâ byê bardzo
  79.  îatwo zmieniane na co chcesz zmieniajâc tylko zmiennâ ôrodowiskowâ $PROMPT
  80.  a pod AmigaOSem  to nie jest takie proste:  Musisz zmieniê  prompta  przez
  81.  wywoîanie komendy  "Prompt" z odpowiednim  argumentem.  To mogîo byê dobre
  82.  kilka lat temu, ale teraz ta  komenda jest za stara i ma sporo ograniczeï.
  83.  I tutaj pojawia  sië SmartPrompt.  Jest on  lepszy od tego  co standardowy
  84.  prompt oferuje i posiada sporo moûliwoôci:
  85.  
  86.  - support dla Multiusera i AmiTCP;
  87.  
  88.  - warunkowe  ciâgi  wstawiane w prompta  kiedy  aktualny  uûytkownik  jest
  89.    rootem lub nie;
  90.  
  91.  - *IXowy styl wyôwietlania ôcieûek lub konwencjonalny;
  92.  
  93.  - dwa typy wyôwietlania ôcieûek;
  94.  
  95.  - to nie jest ûaden hack! przyjazny dla systemu!;
  96.  
  97.  - jest  maîy  (hmmm...  chociaû mógîby byê mniejszy ;)  i "pure"  (jak  to
  98.    przetîumaczyc? :)) wiëc moûna go zrobiê rezydentnym!;
  99.  
  100.  - za darmo!;
  101.  
  102.  - napisany  przeze  mnie!  (wiem  ûe to  jest  najwaûniejsza  zaleta  tego
  103.    programu dla Was ;)))
  104.  
  105.  Program  zawiera jeszcze sporo  innych moûliwoôci  ale chcë Was  potrzymaê
  106.  w niepewnoôci... :)
  107.  
  108.  
  109.     WYMAGANIA
  110.     =========
  111.  
  112.     Kickstart  2.04 (V37), okoîo 8kB wolnej pamiëci do uruchomienia, trochë
  113.  wiëcej na konsole shella i oczywiôcie mój AScreen (oczywiôcie ûartujë, ale
  114.  byîoby bardzo fajnie go uûywaê ;))
  115.  Oczywiôcie pewnie bëdziesz takûe potrzebowaî twardy dysk lub stacjë dysków
  116.  z dyskami,  monitor i klawiaturë  (myôle ûe  nie powinno  byê raczej z tym
  117.  problemów ale kto wie... :))
  118.  I to wszystko! Gotowy do odpalenia!
  119.  
  120.  
  121.     PRZED UÛYCIEM WSTRZÂSNÂÊ
  122.     ========================
  123.  
  124.     Pierwszâ rzeczâ jakâ naleûy zrobiê (po wstrzâôniëciu oczywiôcie :) jest
  125.  skopiowanie SmartPrompta do katalogu  "C:" lub innego,  nadanie mu praw do
  126.  odczytu i uruchamiania dla wszystkich (na Multiuser'ze) i ustawienie flagi
  127.  "p" która oznacza ûe program moûe zostaê zrobiony rezydentnym.  Oczywiôcie
  128.  wstawienie  gdzieô  linii  "Resident C:SmartPrompt" jest  jak  najbardziej
  129.  poûâdane.
  130.  Kolejnym  waûnym krokiem  jest  wstawienie linii  "Prompt *`SmartPrompt*`"
  131.  gdzieô w Twoim shell-startupie.  To kaûe Promptowi wykonywaê  go za kaûdym
  132.  razem gdy shell ma wyôwietliê nowy prompt.
  133.  Hmmm...  Przed tâ liniâ powinieneô  ustawiê zmiennâ ôrodowiskowâ $PROMPT -
  134.  to moûe  byê zmienna  lokalna  lub  globalna.  W tej  zmiennej  bëdzie sië
  135.  znajdowaî ciâg mówiâcy SmartPromptowi jak wyôwietlaê Twój prompt.
  136.  Wiëc wstaw gdzieô linië w stylu: set SPROMPT "%p{ap00}"
  137.  Hmmm...  Nadszedî odpowiedni czas na wyjaônienie wszystkich formatów jakie
  138.  SmartPrompt rozpoznaje:
  139.  
  140.  %u   - aktualny "userid" (root, nobody itd.)  dziaîa tylko pod Multiuserem
  141.         lub AmiTCP! na innych systemach wyôwietla 'nobody'.
  142.  %h   - hostname - nazwa Twojego komputera.  Jest ona pobierana ze zmiennej
  143.         o nazwie $hostname.
  144.  
  145.  %t   - aktualny czas w formacie hh:mm:ss na przykîad 12:23:55.
  146.  %d   - data w formacie dd-mmm-yy na przykîad 26-Sep-98.
  147.  %w   - dzieï tygodnia, na przykîad Thursday.
  148.  
  149.  %%   - wyôwietla znak '%'.
  150.  %q   - wyôwietla '"'.
  151.  %b   - wyôwietla '{'.
  152.  %B   - wyôwietla '}'.
  153.  
  154.  %R{} - jest to warunkowa komenda.  Ciâg wewnâtrz "{"  "}"  nawiasów bëdzie
  155.         wstawiony do prompta jeôli aktualny uûytkownik jest rootem.
  156.         Bez Multiusera lub AmiTCP nic nie wyôwietli.
  157.  %r{} - to samo co powyûej,  z tâ róznicâ ûe wyôwietli  ciâg jeôli aktualny
  158.         uûytkownik nie jest rootem.
  159.         Bez Mulitusera lub AmiTCP wyôwietli podany ciâg.
  160.  UWAGA: w nawiasach mogâ sië znajdowaê takûe  wszystkie formaty z wyjâtkiem
  161.         %R{} i %r{} aby uniknâê rekursji!
  162.  
  163.  %p{} - to powoduje ûe SmartPrompt wyôwietli aktualnâ ôcieûkë.  W  "{"  "}"
  164.         nawiasach sâ dodatkowe formaty:
  165.     a - wyôwietla aktualnâ ôcieûke w zwykîym amigowym stylu, np. "Work:tmp"
  166.         - ustawione standardowo.
  167.     x - wyôwietla aktualnâ ôcieûkë w *IXowym formacie, np. "/Work/tmp".
  168.     d - zamienia nazwy "wolumenów"  (jak to przetîumaczyê?) jak "Work:" lub
  169.         "Ram Disk:"  na nazwy device'ów "DH0:", "RAM:".  Waûne jest to,  ûe
  170.         nawet jeôli ta litera nie zostanie podana, SmartPrompt nadal bëdzie
  171.         zmieniaî nazwy wolumenów  jeôli w nazwie  bëdzie wystëpowaê spacja,
  172.         na nazwy device'ów,  wiëc "Ram Disk:"  zawsze bëdzie  zamieniany na
  173.         "RAM:".
  174.   pxx - "p" oznacza  sposób w jaki  SmartPrompt bëdzie wyôwietlaî  aktualnâ
  175.         ôcieûkë.  Liczba po znaku "p" jest bardzo  waûna i MUSI skîadaê sië
  176.         z dwóch  cyfr,  np. "02".  Tylko  xx ostatnich  skîadników  scieûki
  177.         bëdzie  wyôwietlanych,  wiëc jeôli  aktualna  ôcieûka jest  postaci
  178.         "Work:my/gfx/tmp" i podany numer to "02" zobaczysz tylko "gfx/tmp".
  179.         Jeôli liczba jest wiëksza  niû caîkowita liczba skîadników ôcieûki,
  180.         to zostanie wyôwietlona caîa ôcieûka.
  181.         "00" oznacza ûe zawsze bëdzie wyôwietlona caîoôê.
  182.   Pxx - drugi styl  wyôwietlania  ôcieûek.  Róûnica miëdzy  tâ a poprzedniâ
  183.         polega na tym,  ûe liczba  "xx"  oznacza maksymalnâ dîugoôê ôcieûki
  184.         jaka moûe zostaê wywietlona w caîoôci.  Jeûeli dîugoôê jest wiëksza
  185.         od podanej,  zostanie ona skrócona w odpowiedni sposob.  Jak wyûej, 
  186.         podana liczba musi byê dwucyfrowa.
  187.         Przykîad:  ôcieûka  postaci  "Work:my/gfx/tmp/outcoming"   zostanie
  188.         skrócona do "Work:///outcoming"  jeûeli jej dîugoôê jest wiëksza od
  189.         podanej.  Jak moûna zauwaûyê skrót ten skîada sië z nazwy wolumenu,
  190.         jednego slasha na kaûdy pominiëty skîadnik ôcieûki i z peînej nazwy
  191.         ostatniego  skîadnika na  koniec.  Ostatni skîadnik ôcieûki  zawsze
  192.         jest wyôwietlany nawet  jeôli wynikowy ciâg jest dîuûszy niû podany
  193.         limit.
  194.  
  195.  I to wszystko ludziki! (prawda ûe proste? :))
  196.  Nie, to nie jest takie proste wiëc myôle ûe to jest bardzo dobry moment na
  197.  
  198.     PRZYKÎADY
  199.     =========
  200.  
  201.     Powiedzmy ûe chcesz mieê prompt jak na *IXach, np.
  202.     "[adek@rast:0 archives]$ "
  203.  ze SmartPromptem to jest bardzo proste! popatrz:
  204.     set SPROMPT "[%u@%h:$ascreen %p{xp01}]%R[#]%r{$} "
  205.  hehe... czy nadal rozumiesz coô z tego? Zauwaû ûe ciâg "$ascreen" to nazwa
  206.  zmiennej lokalnej z AScreena która zawiera aktualny numer okna shella. Jak
  207.  widaê  moûesz w ciâgu  podawaê nazwy  zmiennych ôrodowiskowych.  I wîaônie
  208.  tutaj chciaîbym  zdradziê ûe podstawowym ograniczeniem  tego programu jest
  209.  to, ûe nie moûe on podaê numeru aktualnego procesu.  Dlaczego?  Dlatego ûe
  210.  SmartPrompt jest wykonywany przez Prompt jako nowy proces, wiëc jego numer
  211.  jest  inny niû  numer procesu  shella.  Ale nadal moûna go wyôwietliê:  po
  212.  prostu wstaw ciâg "$process" gdzieô w Twojej zmiennej $SPROMPT.
  213.  
  214.  Drugi przykîad:  moûesz takûe spowodowaê  ûe Twój  prompt bëdzie kolorowy!
  215.  Tylko spójrz na linië poniûej:
  216.     set SPROMPT "[%R{*E[32m}%u%R{*E[0m}@%h:$ascreen %p{xp01}]%R[#]%r{$} "
  217.  jest ona  bardzo  podobna  do  poprzedniego  przykîadu z  tâ  róûnicâ,  ûe
  218.  pokazuje aktualnâ nazwë  uûytkownika w kolorze czerwonym  (no przynajmniej
  219.  u mnie ;)). Oczywiôcie "*E[32m" i "*E[0m" sâ standardowymi kodami konsoli.
  220.  
  221.  Ufff...  Moûe to nie jest zbyt  duûo dla Ciebie aby juû wiedzieê  co i jak
  222.  ale po  prostu kombinuj!  Po prostu  wstawiaj  róûne  kombinacje i oglâdaj
  223.  rezultaty!
  224.  
  225.  UWAGA: jeôli  posiadasz zainstalowany  Multiuser  lub/i  AmiTCP,  ale  ich
  226.         odpowiednie biblioteki (multiuser.library/usergroup.library) nie sâ
  227.         wystartowane,  SmartPromp t nie  bëdzie  w ogole  wiedziaî  ûe  one
  228.         istniejâ!
  229.         Ale to  nie powinno  stanowiê problemu,  poniewaû przewaûnie  przed
  230.         pierwszym wyôwietleniem promptu logujesz sië do systemu.
  231.  
  232.  
  233.     PLANY
  234.     =====
  235.  
  236.     Nie jest ich duûo, ale program ten powinien byê maîy, szybki i porëczny
  237.  
  238.  - zrobiê, aby byî w stanie wyôwietlaê aktualny numer procesu shella;
  239.  
  240.  - dodaê rozpoznawanie i wyôwietlanie katalogów domowych i assignów;
  241.  
  242.  
  243.     EPILOG
  244.     ======
  245.  
  246.     Na zakoïczenie chciaîbym  podziëkowaê wszystkim którzy chcâ byê z naszâ
  247.  "kochanâ" Amiga, na zîe i na dobre  (zdaje sië ûe teraz mamy te "zîe" :().
  248.  I na sam koniec specjalne, indywidualne "greetsy":
  249.  
  250.  Robert "rEkiN" Rëdziak   - przekonaî  mnie do napisania  tego "czegoô" :))
  251.                             i pokazal inne, podobne programy.
  252.  Matthias Bethke          - za jego PromptPath z którego  wziâîem pomysî na
  253.                             drugi styl ôcieûek.
  254.  Krystian "Tygrys" Wîosek - dziëki któremu i specjalnie dla  niego powstaîa
  255.                             polska wersja dokumentacji :)))
  256.  wszyscy czîonkowie grupy
  257.                   sEASONS - eee... oni i tak nie znajâ polskiego :)))
  258.